@allyhub/sdk 0.1.0-alpha.8 → 0.2.0-next.1

package/LICENSE.md

@@ -0,0 +1,241 @@
+AllyHub Software License
+
+Copyright (c) 2026 AllyHub, Inc. ("AllyHub"). All rights reserved.
+
+This software (the AllyHub command-line tool, its SDK, runtime and the
+packages they depend on) is proprietary. It is not open source.
+
+1. Permitted use. You may install and run the software, unmodified, to make,
+   check, preview and render videos and decks, including for commercial
+   purposes. What you make with it is yours.
+
+2. Restrictions. Except as this license permits or applicable law requires,
+   you may not copy, modify, adapt, translate, sublicense, sell, rent, lease,
+   publish or otherwise distribute the software, create derivative works of
+   it, or reverse engineer, decompile or disassemble it.
+
+3. Cloud services. AllyHub's cloud tools (sign-in, research, images, voice,
+   video) are separate services governed by AllyHub's terms of service.
+
+4. Trademarks. This license grants no right to use the name "AllyHub" or its
+   logos.
+
+5. No warranty. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY
+   KIND, EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF MERCHANTABILITY,
+   FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL
+   ALLYHUB BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY ARISING FROM,
+   OUT OF OR IN CONNECTION WITH THE SOFTWARE OR ITS USE.
+
+6. Third-party code. Parts of the software are adapted from HyperFrames,
+   licensed under the Apache License, Version 2.0 (see NOTICE). Those parts
+   remain under that license, reproduced below, and nothing in this license
+   limits your rights under it.
+
+7. Starter components. The starter components in the "components" folder,
+   which "allyhub add" copies into your workspace, are licensed under the MIT
+   License (see components/LICENSE): once copied, you may change, use and
+   share them freely.
+
+--------------------------------------------------------------------------------
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/NOTICE

@@ -79,3 +79,88 @@ public-domain simplex noise reference ("Simplex noise demystified", 2005).
 
 The Apache License, Version 2.0 is reproduced at the end of LICENSE; those
 parts remain under it.
+
+How a voice was recorded (packages/engine/src/recording/) builds a room's
+impulse response after pyroomacoustics
+(https://github.com/LCAV/pyroomacoustics), under the MIT License: the image
+source method in a box with each reflection's amplitude per octave band,
+fractional delays written with a Hann-windowed sinc, the octave bands joined
+by Antoni's power-complementary crossovers, the late tail as random impulses
+of growing density decaying by each band's reverberation time, Eyring's
+reverberation time with the air's absorption, and the materials' absorption
+coefficients and the air's absorption table (pyroomacoustics/data/
+materials.json, acoustics.py, simulation/ism.py and rt.py, libroom_src/
+room.cpp). room.ts says so in its header.
+
+  Copyright (c) 2014-2017 EPFL-LCAV
+
+  Permission is hereby granted, free of charge, to any person obtaining a
+  copy of this software and associated documentation files (the
+  "Software"), to deal in the Software without restriction, including
+  without limitation the rights to use, copy, modify, merge, publish,
+  distribute, sublicense, and/or sell copies of the Software, and to permit
+  persons to whom the Software is furnished to do so, subject to the
+  following conditions:
+
+  The above copyright notice and this permission notice shall be included
+  in all copies or substantial portions of the Software.
+
+  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+  OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+  MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN
+  NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
+  DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
+  OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
+  USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+Its loudness (loudness.ts) puts BS.1770's K-weighting filters at any sample
+rate from their analogue prototypes, as pyloudnorm
+(https://github.com/csteinmetz1/pyloudnorm) does, Copyright (c) 2021
+Christian Steinmetz, under the MIT License; its filters follow Robert
+Bristow-Johnson's Audio EQ Cookbook, and its compressor Giannoulis, Massberg
+and Reiss, "Digital Dynamic Range Compressor Design" (JAES, 2012).
+
+---
+
+AllyHub
+Copyright (c) 2026 AllyHub, Inc. All rights reserved.
+
+This product is proprietary; see LICENSE.
+
+The centripetal Catmull-Rom tangents in src/curve.ts follow three.js's
+CatmullRomCurve3 (src/extras/curves/CatmullRomCurve3.js)
+(https://github.com/mrdoob/three.js),
+Copyright 2010-2026 three.js authors, under the MIT License:
+
+  Permission is hereby granted, free of charge, to any person obtaining a
+  copy of this software and associated documentation files (the
+  "Software"), to deal in the Software without restriction, including
+  without limitation the rights to use, copy, modify, merge, publish,
+  distribute, sublicense, and/or sell copies of the Software, and to permit
+  persons to whom the Software is furnished to do so, subject to the
+  following conditions:
+
+  The above copyright notice and this permission notice shall be included
+  in all copies or substantial portions of the Software.
+
+  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+  OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+  MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN
+  NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
+  DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
+  OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
+  USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+The arc-length parametrisation (Gauss-Legendre quadrature per segment,
+inverted by Newton steps with a bisection fallback) and the timing of
+keyframes by a monotone cubic follow the approach of the splines library
+(https://github.com/AudioSceneDescriptionFormat/splines), Copyright (c)
+2018-2026 Matthias Geier, under the MIT License (the same terms as above).
+No code of it is copied.
+
+The moiré a sensor makes of a screen (src/moire.ts) follows
+the screen-capture simulation of UniDemoiré
+(https://github.com/4DVLab/UniDemoire, unidemoire/models/shooting), Copyright
+(c) 2024 4DVLab, under the MIT License: a screen's RGB subpixels, the
+projective transform, the sensor's Bayer filter. It is worked out in closed
+form per pixel; no code of it is copied.

package/client.d.ts

@@ -1,6 +1,6 @@
 // Types of the imports AllyHub's build understands. Add "@allyhub/sdk/client" to `types` in tsconfig.json.
 
-type AllyHubMedia = import("@allyhub/engine/stage").MediaInfo;
+type AllyHubMedia = import("@allyhub/sdk").MediaInfo;
 type AllyHubRow = Record<string, string | number>;
 
 declare module "*.png" {
@@ -71,6 +71,50 @@ declare module "*.woff2" {
   const media: AllyHubMedia;
   export default media;
 }
+declare module "*.m4v" {
+  const media: AllyHubMedia;
+  export default media;
+}
+declare module "*.qt" {
+  const media: AllyHubMedia;
+  export default media;
+}
+declare module "*.woff" {
+  const media: AllyHubMedia;
+  export default media;
+}
+declare module "*.ttf" {
+  const media: AllyHubMedia;
+  export default media;
+}
+declare module "*.otf" {
+  const media: AllyHubMedia;
+  export default media;
+}
+declare module "*.glb" {
+  const media: AllyHubMedia;
+  export default media;
+}
+declare module "*.gltf" {
+  const media: AllyHubMedia;
+  export default media;
+}
+declare module "*.bin" {
+  const media: AllyHubMedia;
+  export default media;
+}
+declare module "*.ktx2" {
+  const media: AllyHubMedia;
+  export default media;
+}
+declare module "*.hdr" {
+  const media: AllyHubMedia;
+  export default media;
+}
+declare module "*.exr" {
+  const media: AllyHubMedia;
+  export default media;
+}
 declare module "*.csv" {
   /** One object per row, keyed by the header; numeric columns are numbers. */
   const rows: AllyHubRow[];

package/dist/anim.js

@@ -1,75 +1,2 @@
-// Animation helpers. All are pure functions of time (the skill's references/core.md, "Animation helpers").
-export const clamp = (x, lo = 0, hi = 1) => Math.min(hi, Math.max(lo, x));
-export const lerp = (a, b, x) => a + (b - a) * x;
-/** Progress of t through [start, start + dur], clamped to 0–1. */
-export const progress = (t, start, dur) => dur <= 0 ? (t >= start ? 1 : 0) : clamp((t - start) / dur);
-export const ease = {
-    linear: ((x) => x),
-    in: ((x) => x * x * x),
-    out: ((x) => 1 - Math.pow(1 - x, 3)),
-    inOut: ((x) => x < 0.5 ? 4 * x * x * x : 1 - Math.pow(-2 * x + 2, 3) / 2),
-    outExpo: ((x) => (x >= 1 ? 1 : 1 - Math.pow(2, -10 * x))),
-    outBack: ((x) => {
-        const c1 = 1.7;
-        const c3 = c1 + 1;
-        return 1 + c3 * Math.pow(x - 1, 3) + c1 * Math.pow(x - 1, 2);
-    }),
-    /** A damped spring that settles at 1. */
-    spring(damping = 7, frequency = 3.2) {
-        return (x) => x >= 1
-            ? 1
-            : 1 -
-                Math.exp(-damping * x) * Math.cos(frequency * Math.PI * 2 * x * 0.5);
-    },
-};
-/** The value at time t of a tween from `from` to `to`. */
-export function tween(t, opts = {}) {
-    const { from = 0, to = 1, start = 0, dur = 0.5, ease: e = ease.out } = opts;
-    return lerp(from, to, e(progress(t, start, dur)));
-}
-/** The delay of the i-th element of a staggered group. */
-export const stagger = (i, gap) => i * gap;
-function hashSeed(seed) {
-    const s = String(seed);
-    let h = 2166136261;
-    for (let i = 0; i < s.length; i++) {
-        h ^= s.charCodeAt(i);
-        h = Math.imul(h, 16777619);
-    }
-    return h >>> 0;
-}
-/** A deterministic random number generator: the same seed, the same numbers. */
-export function rand(seed) {
-    let a = hashSeed(seed);
-    return () => {
-        a = (a + 0x6d2b79f5) | 0;
-        let t = Math.imul(a ^ (a >>> 15), 1 | a);
-        t = (t + Math.imul(t ^ (t >>> 7), 61 | t)) ^ t;
-        return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
-    };
-}
-/**
- * Sets the largest font size in [min, max] at which the element's text fits
- * its own box (no overflow). The element needs a definite width (and height,
- * to limit lines). Returns the size chosen.
- */
-export function fitText(el, opts) {
-    const fits = () => el.scrollWidth <= el.clientWidth + 1 &&
-        el.scrollHeight <= el.clientHeight + 1;
-    let lo = opts.min;
-    let hi = opts.max;
-    el.style.fontSize = `${hi}px`;
-    if (fits())
-        return hi;
-    while (hi - lo > 0.5) {
-        const mid = (lo + hi) / 2;
-        el.style.fontSize = `${mid}px`;
-        if (fits())
-            lo = mid;
-        else
-            hi = mid;
-    }
-    el.style.fontSize = `${lo}px`;
-    return lo;
-}
-//# sourceMappingURL=anim.js.map
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+export const clamp=(t,n=0,e=1)=>Math.min(e,Math.max(n,t)),lerp=(t,n,e)=>t+(n-t)*e,progress=(t,n,e)=>e<=0?t>=n?1:0:clamp((t-n)/e),ease={linear:(t=>t),in:(t=>t*t*t),out:(t=>1-Math.pow(1-t,3)),inOut:(t=>t<.5?4*t*t*t:1-Math.pow(-2*t+2,3)/2),outExpo:(t=>t>=1?1:1-Math.pow(2,-10*t)),outBack:(t=>1+2.7*Math.pow(t-1,3)+1.7*Math.pow(t-1,2)),spring(t=7,n=3.2){return e=>e>=1?1:1-Math.exp(-t*e)*Math.cos(n*Math.PI*2*e*.5)}};export function tween(t,n={}){const{from:e=0,to:o=1,start:r=0,dur:i=.5,ease:c=ease.out}=n;return lerp(e,o,c(progress(t,r,i)))}export const stagger=(t,n)=>t*n;function s(t){const n=String(t);let e=2166136261;for(let o=0;o<n.length;o++)e^=n.charCodeAt(o),e=Math.imul(e,16777619);return e>>>0}export function rand(t){let n=s(t);return()=>{n=n+1831565813|0;let e=Math.imul(n^n>>>15,1|n);return e=e+Math.imul(e^e>>>7,61|e)^e,((e^e>>>14)>>>0)/4294967296}}export function fitText(t,n){const e=()=>t.scrollWidth<=t.clientWidth+1&&t.scrollHeight<=t.clientHeight+1;let o=n.min,r=n.max;if(t.style.fontSize=`${String(r)}px`,e())return r;for(;r-o>.5;){const i=(o+r)/2;t.style.fontSize=`${String(i)}px`,e()?o=i:r=i}return t.style.fontSize=`${String(o)}px`,o}

package/dist/define.d.ts

@@ -1,14 +1,17 @@
-import { type GraphicLayer, type LayerTiming, type StageContext, type TimeShape } from "@allyhub/engine/stage";
+import { type GraphicLayer, type LayerTiming, type StageContext, type TimeShape } from "@allyhub-next/video-core";
 import type { PropSchema, Timed } from "./props.js";
-export type { StageContext } from "@allyhub/engine/stage";
+export type { StageContext } from "@allyhub-next/video-core";
 /** What every graphic layer takes besides a component's own props. */
 export interface LayerOptions extends LayerTiming {
     /**
      * "front" (default): at its place in the part's layers, over those
      * listed before it. "behind-person": right over the part's own footage
      * and under its speaker, cut out with the take's person matte.
+     * "overlay": over the finished picture, as an app lays captions over a
+     * video after it is filmed: over every other layer, and not marked by
+     * the camera (`capture`), motion blur, `post` or the LUT.
      */
-    z?: "front" | "behind-person";
+    z?: "front" | "behind-person" | "overlay";
 }
 /** Text for people: one string, or by language. */
 export type Label = string | Record<string, string>;
@@ -52,7 +55,7 @@ export interface ComponentDefinition<P extends object> {
     render(el: HTMLElement, t: number, props: P, ctx: StageContext): void;
 }
 /** A component: a function that makes a graphic layer from its props and the layer options. */
-export type Component<P extends object> = ((opts: LayerOptions & Timed<P>) => GraphicLayer<P>) & {
+export type Component<P extends object> = ((...opts: Partial<Timed<P>> extends Timed<P> ? [opts?: LayerOptions & Timed<P>] : [opts: LayerOptions & Timed<P>]) => GraphicLayer<P>) & {
     componentName: string;
     info: ComponentInfo;
 };
@@ -63,6 +66,9 @@ export type Component<P extends object> = ((opts: LayerOptions & Timed<P>) => Gr
 export declare const LAYER_OPTIONS: readonly string[];
 /** Where props hold times, from their schema; undefined when none do. */
 export declare function timeShape(props: Readonly<Record<string, PropSchema | undefined>>): TimeShape | undefined;
+/** The layer options of an options object, and the rest. */
+/** A layer's timing and z, and the rest of its options. */
+export declare function splitLayer<T extends LayerOptions>(opts: T): [LayerOptions, Omit<T, keyof LayerOptions>];
 /** Makes a component: a function that returns a graphic layer. */
 export declare function defineComponent<P extends object>(def: ComponentDefinition<P>): Component<P>;
 export interface CustomOptions extends LayerOptions {

package/dist/define.js

@@ -1,95 +1,2 @@
-import { LAYER_BRAND, } from "@allyhub/engine/stage";
-/**
- * Layer options share one object with a component's props, so these names
- * are reserved: a component cannot have props called this.
- */
-export const LAYER_OPTIONS = ["at", "until", "dur", "z"];
-/** Where props hold times, from their schema; undefined when none do. */
-export function timeShape(props) {
-    const of = (s) => {
-        if (s.type === "time")
-            return true;
-        if (s.type === "list")
-            return of(s.of);
-        if (s.type === "object")
-            return timeShape(s.fields);
-        return undefined;
-    };
-    const out = {};
-    for (const [k, s] of Object.entries(props)) {
-        const shape = s ? of(s) : undefined;
-        if (shape !== undefined)
-            out[k] = shape;
-    }
-    return Object.keys(out).length > 0 ? out : undefined;
-}
-/** The layer options of an options object, and the rest. */
-function splitLayer(opts) {
-    const { at, until, dur, z, ...rest } = opts;
-    return [
-        {
-            ...(at === undefined ? {} : { at }),
-            ...(until === undefined ? {} : { until }),
-            ...(dur === undefined ? {} : { dur }),
-            ...(z === undefined ? {} : { z }),
-        },
-        rest,
-    ];
-}
-/** Makes a component: a function that returns a graphic layer. */
-export function defineComponent(def) {
-    const names = [
-        ...Object.keys(def.props ?? {}),
-        ...Object.keys(def.defaults ?? {}),
-        ...Object.values(def.examples ?? {}).flatMap((e) => Object.keys(e)),
-    ];
-    const clash = [...new Set(names.filter((k) => LAYER_OPTIONS.includes(k)))];
-    if (clash.length > 0) {
-        throw new Error(`${def.name}: ${clash.join(", ")} is a layer option, not a prop name`);
-    }
-    const times = timeShape(def.props ?? {});
-    const make = (opts) => {
-        const [layer, rest] = splitLayer(opts);
-        // Word references in time() props are seconds by the time mount runs.
-        const props = { ...def.defaults, ...rest };
-        return {
-            [LAYER_BRAND]: "graphic",
-            ...layer,
-            component: def.name,
-            props,
-            ...(times ? { times } : {}),
-            mount: (el, p, ctx) => {
-                def.mount(el, p, ctx);
-            },
-            render: (el, t, p, ctx) => {
-                def.render(el, t, p, ctx);
-            },
-        };
-    };
-    const info = {
-        name: def.name,
-        label: def.label ?? def.name,
-        ...(def.summary === undefined ? {} : { summary: def.summary }),
-        props: Object.fromEntries(Object.entries(def.props ?? {}).filter((e) => e[1] !== undefined)),
-        examples: def.examples ?? {},
-        hidden: def.hidden ?? false,
-    };
-    return Object.assign(make, { componentName: def.name, info });
-}
-/** A graphic layer written directly in the output, for what no component does. */
-export function custom(opts) {
-    const [layer] = splitLayer(opts);
-    return {
-        [LAYER_BRAND]: "graphic",
-        ...layer,
-        component: "custom",
-        props: {},
-        mount: (el, _props, ctx) => {
-            opts.mount?.(el, ctx);
-        },
-        render: (el, t, _props, ctx) => {
-            opts.render(el, t, ctx);
-        },
-    };
-}
-//# sourceMappingURL=define.js.map
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{LAYER_BRAND as c}from"@allyhub-next/video-core";export const LAYER_OPTIONS=["at","until","dur","z"];export function timeShape(e){const o=n=>{if(n.type==="time")return!0;if(n.type==="list")return o(n.of);if(n.type==="object")return timeShape(n.fields)},t={};for(const[n,r]of Object.entries(e)){const s=r?o(r):void 0;s!==void 0&&(t[n]=s)}return Object.keys(t).length>0?t:void 0}export function splitLayer(e){const{at:o,until:t,dur:n,z:r,...s}=e;return[{...o===void 0?{}:{at:o},...t===void 0?{}:{until:t},...n===void 0?{}:{dur:n},...r===void 0?{}:{z:r}},s]}export function defineComponent(e){const o=[...Object.keys(e.props??{}),...Object.keys(e.defaults??{}),...Object.values(e.examples??{}).flatMap(i=>Object.keys(i))],t=[...new Set(o.filter(i=>LAYER_OPTIONS.includes(i)))];if(t.length>0)throw new Error(`${e.name}: ${t.join(", ")} is a layer option, not a prop name`);const n=timeShape(e.props??{}),r=i=>{const[m,l]=splitLayer(i??{}),d={...e.defaults,...l};return{[c]:"graphic",...m,component:e.name,props:d,...n?{times:n}:{},mount:(u,p,a)=>{e.mount(u,p,a)},render:(u,p,a,f)=>{e.render(u,p,a,f)}}},s={name:e.name,label:e.label??e.name,...e.summary===void 0?{}:{summary:e.summary},props:Object.fromEntries(Object.entries(e.props??{}).filter(i=>i[1]!==void 0)),examples:e.examples??{},hidden:e.hidden??!1};return Object.assign(r,{componentName:e.name,info:s})}export function custom(e){const[o]=splitLayer(e);return{[c]:"graphic",...o,component:"custom",props:{},mount:(t,n,r)=>{e.mount?.(t,r)},render:(t,n,r,s)=>{e.render(t,n,s)}}}

package/dist/dom.d.ts

@@ -1,4 +1,4 @@
-import { type CaptionTrackCue, type ContentOptions, type InlineMark, type StageContext } from "@allyhub/engine/stage";
+import { type CaptionTrackCue, type ContentOptions, type InlineMark, type StageContext } from "@allyhub-next/video-core";
 /** Inline styles: camelCase or `--custom` properties; numbers are pixels. */
 export type Style = Partial<Record<string, string | number>>;
 export declare function h(tag: string, style?: Style, children?: (Node | string)[], cls?: string): HTMLElement;